package org.david.code.dao;

import java.io.Serializable;
import java.math.BigInteger;
import java.sql.SQLException;
import java.util.List;
import java.util.Map;

import org.hibernate.Criteria;
import org.hibernate.HibernateException;
import org.hibernate.Query;
import org.hibernate.Session;
import org.hibernate.criterion.DetachedCriteria;
import org.hibernate.criterion.Projections;
import org.springframework.orm.hibernate3.HibernateCallback;
/**
 * 泛型Dao，满足通用的增删改查(CRUD)的操作
 * @author fang junfeng
 * @param <T> a type variable
 */
public interface IGenericDao<T> {

	/**
	 * 根据id得到一个对象
	 * @param id
	 * @return
	 */
	T get(Serializable id);
	
	/**
	 * 根据查询条件得到一个对象
	 * @param query
	 * @return
	 */
	T getUniqueResult(final DetachedCriteria query);
	
	/**
	 * 根据查询条件得到对象的数量
	 * @param query
	 * @return
	 */
	int getCount(DetachedCriteria query);
	
	/**
	 * 根据查询条件得到对象列表
	 * @param query
	 * @return
	 */
	List<T> getList(DetachedCriteria query);
	
	/**
	 * 根据查询条件得到分页对象列表
	 * @param query
	 * @param firstResult
	 * @param maxResults
	 * @return
	 */
	List<T> getList(DetachedCriteria query, int firstResult, int maxResults);
	
	/**
	 * 删除一个对象
	 * @param object
	 */
	void remove(T object);
	/**
	 * 根据id删除一个对象
	 * @param id
	 */
	void remove(Serializable id);                               
	
	/**
	 * 保存一个对象，能处理修改和新增操作
	 * @param object
	 * @return
	 */
	T save(T object);
	
	/**
	 * hql更新或者删除
	 * @param hql
	 * @param map
	 * @return
	 */
	int updateOrDelete(final String hql, final Map<String, Object> map);
	
	
	/**
	 * 更新一个对象
	 * @param object
	 * @return
	 */
	T update(T object);
	
	/**
	 * 创建Query
	 * 
	 * @param queryString
	 * @param values
	 * @return
	 */
	public Query createQuery(String queryString) ;
	
	/**
	 * 创建Query
	 * 
	 * @param queryString
	 * @param values
	 * @return
	 */
	public Query createQuery(String queryString, Object... values)  ;

	/**
	 * Native SQL(原生SQL查询)
	 * 
	 * @param queryString
	 * @return
	 */
	public Query createSQLQuery(String queryString)  ;
	
	/**
	 * 获取Session
	 * 
	 * @return
	 */
	public Session getSession() ;

	/**
	 * 根据HQL语句查询对象，支持不确定个数的参数
	 * 
	 * @param queryString
	 *            HQL语句
	 * @param values
	 *            0-N个参数
	 * @return
	 */
	public List<T> query(String queryString, Object... values);
	
	
}
